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UNIV4VEC PROGRAM 


1.0 SCOPE 

This document describes the UNIV4VEC Program which Is one of the BADHWAR SYSTEM 
programs. Included In this system are the CLASFYT, CLASFY6, PARPLT, PARHIS, 
PARCLAS and MISMAP programs. 

The UNIV4VEC program reads a CLASFYG vector parameter file and converts It to 
a four channel universal formatted file. This universal formatted file Is 
primarily used as Input to the CLASSY processor. 
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2.0 APPLICABLE DOCUMENTS 


The following documents form a part of this specification: 

AO 63-3308-03 Transferring Badhwar Software. 

AD NAS 9-15200 Technical Memorandum Format Specifications for LACIE (Phase 
III) and Accuracy Assessment Computer Data Products. 
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3.0 SYSTEM DESCRIPTION 


3.1 SYSTEM FLOWCHART 

The system level data flow diagram for the UNIV4VEC Program Is depicted In 
Figure 3.1 .1 . 
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Figure 3.3.1 System level flow diagram for the UHIV4VEC Program. 



3.2 HARDWARE DESCRIPTION 


The software for the UNIV4VEC Program Is operational on the IBM 3031 
computer at Purdue, LARS. 

3.3 SOFTWARE DESCRIPTION 

The UNIV4VEC Program reads a CLASFYG vector parameter file header and sets 
the appropriate bytes to Indicate a four channel universal file with 196 
bytes per channel. The data records from the parameter file are read. 

Each of the pixel vector coefficients within the parameter file are 
assumed to be within the range 0 to 9999, therefore, all coefficients are 
divided by forty to Insure that the resulting coefficient value Is less 
than 256 and will store In a byte. After division, the element Is stored 
In the output buffer. When all elements In the line are processed, the 
buffer Is written. 
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3.4 FILE DESCRIPTIONS 

3.4.1 INPUT FILE 

UNIV4VEC accepts as Input, a parameter file output from the CLASFYG Program. 
This parameter file consists of 118 records. The first record'ls a header 
record consisting of 3060 bytes. The header record follows universal 
format requirements. Records 2-118 contain data records. Each data record 
consists of 196 pixel vectors. Each pixel vector consists of four 
coefficients: a, 6, t^ and x . Each coefficient contains a signed Integer 
value stor^ In a thirty- two bit full word. (For a complete description 
of this file see "AS-BUILT" DESIGN SPECIFICATION FOR CLASFYG LQlSCO-16649/ 
JSC-17369). 

3.4.2 OUTPUT FILE 

The output file Is In universal format and contains the following records: 
Header Record 

The header record contains all Information from the CLASFYG header. In 
addition, the following bytes are assigned so that the resulting header 
conforms to the universal format standards: 


BYTE(S) 


CONTENTS 

(DECIMAL) 

DESCRIPTION 

81 

m 

240 

First four bits on to Indicate four channels 

89 

u 

1 

Processing flag 

90 

m 

4 

Number of channels per physical record 

91 

m 

8 

Number of bits In pixel (always ■ 8) 

92-93 

m 

1 

Start of the video data (always ■ 1) 

96-97 

M 

196 

Number of pixels per scan line 

100-101 

m 

900 

Physical record size In bytes (multiple of 180 bytes) 

104 

m 

1 

Number of records In a data set 

105-105 

9 

70 

Length of ancillary block 

108-109 

9 

1 

Beginning pixel within the channel 

110-111 

M 

196 

Last pixel within the channel 

753 

m 

32 

Word size of machine In bits 

1778 

m 

1 

Number of data sets In record 

1786 

m 

4 

Number of channels within the first physical 
record of the data set 
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Data Records 


There are 117 four channel data records of length 900 eight bit-bytes. Each 
data record contains seventy-two bytes of ancillary data followed by 196 
bytes representing the a coefficient, 196 bytes representing the 6 coefficient, 
196 bytes representing the t^ coefficient, and 196 bytes representing the 
coefficient. The remaining forty-four bytes are zero filled to complete 
the 900 bytes. All coefficients from the parameter file are divided by forty 
to Insure that the resulting number will store In a byte. 

(For a complete description of the universal file format see Earth Resources 
Data Format Book, Volume 1, PH0-TR543. 
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3.5 SOFTWARE DESCRIPTION 


3.5.1 UNIV4VEC 
Purpose 

The UNIV4VEC Program reformats a universal file from a CLASFYG vector file. 

Linkages 

None. 

Interface 
Calling sequence: 

Not applicable. (UfiIV4VEC EXEC which can be used to load and execute 
UNIV4VEC Is described In Section 4.0). 

Calling sequence parameters: 

Not applicable. 

Function value: 

Not applicable. 

Labeled conmon parameters: 

None. 

Blank Common parameters: 

None. 

Inputs 

Unit Type Description 

10 Sequential data Input classification file In vector form 

(See Section 3.4.1). 
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Description 


Output 

Unit Type 

5 Tenninal Report 

29 Sequential data; Disk Output classification file In 

universal format. (See Section 3.4.2) 


Storage Requirement 
Not applicable. 

Description 

The UNIV4VEC Program reads a CLASFY6 vector parameter file header and sets 
the appropriate bytes to Indicate a four channel universal file with 196 
bytes per channel. The data records from the parameter file are read 
and each pixel vector coefficient Is divided by forty. This Insures that 
each coefficient value Is less than 255 and will store In a byte. After 
division, the element Is stored In the output buffer. When all elements 
In the line are processed, the buffer Is written. 

Flowchart 
Not applicable. 

Listing 

Not applicable. 
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3.5.2 PROGRAM CLSRCL 


Purpose 

CLSRCL reads information necessary to define (FILEDEF) the classification file for the 
UNIV4VEC program. 

Linkages 

CLSRCL is executed by UNIV4VEC EXEC. 

Interface 
None. 

Inputs 
Unit 
23 

Outputs 
None. 

Storage reouirement 
Not applicable. 

Description 

The CLSRCL subroutine reads from file 23 to recall the classification file name 
and unit number. If the file is empty, an error message is written and the 
program terminates. If the file is not empty, the EXEC to FILEDEF (define the 
file to the system) the classification file is written. This is necessary 
because of the possibility of the file definition being lost due to a system 
error on one of the program executions. 

Flowchart 
Not applicable. 

Listing 

See Appendix A for routine listing. 


Type Description 

Sequential Unit number associated with classification file 

and classification file name. 
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4.0 OPERATION 


4.1 OPERATING DESCRIPTION 

UNIV4VEC is operational on the IBM 3031 computer at LARS, West Lafayette, 
Indiana. 

The UNIV4VEC program Is one of the programs of the BADHWAR SYSTEM which 
Includes the programs CLASFYT, CLASFYG, MISHAP, PARPLT, PARHIS, and PARCLS. 

4.2 COMMANDS DESCRIPTION 

To execute UNIV4VEC, the user enters a series of commands which Invoke the 
JOB CONTROL SOFTWARE. These commands are divided Into two classes namely 
(1) FUNCTION commands and (2) PROGRAM commands. The FUNCTION commands, 
which perform all the functions except executing the program are resuable; 
I.e., once they are Invoked they remain in effect until reentered. The 
PROGRAM commands, which execute the program, must be reentered each time the 
program Is to be executed. 

The following list gives the conirnands required to execute the UNIV4VEC 
program. They are all FUNCTION conmands except the PROGRAM coimnand UNIV4VEC. 
These commands must be given In the listed order. 

START 

DEFCUS 

UNIV4VEC 

END 

The following sections describe each of the commands In detail. Input fields 
are separated by blanks. If more than one word Is required to describe an 
Input field, the descriptive text Is enclosed In pointed brackets <>. If 
an Input Is optional the field Is enclosed in square brackets []. Do not 
Include these explanatory characters <> [] when actually submitting Input to 
the computer. To enter a command the user types one Input per defined Input 
field and separates each field with a blank. 
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4.2.1 START 

The START command spools the user's console file. The use of this command, 
along with the END COTmand, will provide a listing of all information 
appearing on the user's console file. (If running an interactive job, this 
is the terminal. If running a batch job, this is a system defined device.) 
The START command is invoked by the user typing the following: 

START 

4.2.2 OEFCLAS 

The DEFCLAS command defines the input Classification file. The user can 
use this comnand to define a Classification file on tape or disk. The 
DEFCLAS command has the following forms and is invoked by typing one of 
the following, according to the user's requirement. 

If the file is on tape - 

DEFCLAS TAPE# FILE# (lAPE DENSITY) 

If the file is on disk - 

DEFCLAS FILENAME FILETYPE FILEMODE 

This command remains in effect for the use of any of the BADHWAR SYSTEM 
PROGRAM conmands and does not have to be reissued unless the user wishes 
to redefine the input Classification File. 
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4.2.3 UNIV4VEC 

The UNIV4VEC command is a PROGRAM command and is used to invoke the 
execution of the UNIV4VEC program. This command must not be used unless 
the KFCLAS command has been previously issued. The UNIV4VEC command 
is invoked by the user typing the following: 

UNIV4VEC <0UTPUT FILENAME> <0UTPUT FILETYPE> 

The output file from the UNIV4VEC program is written on the user A disk 
under the name specified in the EXEC arguments. 


4.2.4 END 

This command closes the user's console file and causes a spooled copy to 
be sent to the HOUSTON printer. This command has no effect if the START 
command was not previously issued. The END command is invoked by the 
user typing the following. 

END 

4.3 OPERATING EXAMPLE 

For our example we will assume the following: 

The user has executed the CLASFYG program and its output file is named 
0123 COEF. 

COMMAND EXPLANATION OR ACTION TAKEN 


START 

DEFCLAS 0123 COEF B 


UNIV4VEC 0123 UNIVCOEF 
END 


Spool the users console 

Defines a Class file on the users B disk. 
This data is on a disk which the user has 
previously attached to his disk using a B 
mode. 

Executes the UNIV4VEC PROGRAM. 

Closes the user's console file and spools 
the files to the HOUSTON printer. 
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